PUG 01 14:33 FR 



8454329786 TO PTO-fiMENDMENTS P. 13 



z/Architecture 




Principles of Operation 



PA(S 13/20* RCVD AT 811/2005 1:55:16 PM [Eastern Daylight Time] * SVR:USPTOffX^^^^ 



ftUG 01 '05 14:33 FR 



8454329786 TO PTO-fiMENDMENTS P. 14 



Note: ™- ^ 

Before using this information ancf th$ product it supports, be sura to read the general intormation under "Notices" on page xv. 

Softcopy Note: — ™« 

The reader should be aware of the fact that this publication contains many symbote, such as superscripts, that rtiay f\ot dteplay 
cofrectly with any given hardware or software. THe definitive version of this puWicatfon is the hardcopy version. 



First Edition (December 2000) 

This publication is provided for use in conjunction with other refevant IBM puWications. and JBM makes no warranty, express or 
implied, about its completeness or accuracy. The information in this publfcation Is current as of its publication date but is subject to 
change wfthotit notice. 

Publications are not stocked at the address given below. Requests for IBM publications should be made to your IBM r^resentative 
or to the IBM brartch office serving your locality. 

A fomn for raader^ commentfi is pmvided at the back of this publication. If the form has been removed, address your comma/its to: 
International Business Machines Conxratign 
Department $5JA Mail Station P384 
2455 South Road 
Rough keepsie, N.Y.. 12001-5400 
United States of America 

FAX (United States & Canada): S46-^432-9405 

. FAX (Other Countries); Your International Access Code+1*^S+432-9405 
IBMUnk (United States customers only): IBMU$M10(MHVRCFS) 
Inlemet e-mail: mhvrcfs dus.ibm.com 
Wortd Wide Web: httpi//www.ibm.oom^90/os390/webC|S.html 

When i^u send information to IBM, you grant IBM a non-exdusive right to use or distrttwte the Informatton in any way it believes 
appropriate wtthout incurring any obligatkxi to you. 

© Copyright Intemationaf Business Machines Corporation 1990. 2000. Ml rights reserved. 

US Government Users Restricted Rights - Use. duplteation or di5ck?sure restricted by GSA ADP Schedule Cor^tract with IBM Corp. 

PAGE 14l20'RCVDATm051:55:16PM [Eastern Daylight Tiine]*SVR:USPTO{F^^^^ 



AUG 01 '05 14:34 FR 



8454329786 TO PTO-fiMENDMENTS P. 15 



31 -bit mode, may be set to zeros or may remain 
ur>changed from their original values. 

In the 24'bit or 31-brt addressing mode, the con- 
tents of bit positions 0-31 of. general registers Ri 
and Ri + 1 always remain unchanged. 

The amount of processing that results in the 
setting of condition code 3 is determined by the 
CPU on the basis of improving system perform^ 
ance, and it may be a different amount each time 
the Instruction is executed. 

When the Rz register Is the same register as the 
Ri or Ri + 1 register, the results are unpredict- 
able. 

When Ri or R2 is zero, the results are unpredict- 
able. 

When the second operand overlaps the first 
operand, the resutts are unpredictable. 

Access exceptions for the portion of the first 
operand to the right of the last byte processed 
may or may not be recognized. For an operand 
longer than 4K bytes, access exceptions are not 
recognized for locations more than 4K bytes 
beyond the last byte processed. 

Access exceptions for all 266 bytes of the second 
operand may be recognized, even if not all bytes 
are used. 

Access exceptions are not recognized if the Ri 
field is odd. When the length of the first operand 
is zero, no access exceptions for the first operand 
are recognized. 

Resulting Condition Code: 

0 Entire first operand processed without finding 
a byte equal to the test byte 

1 First-operand byte Is equal to the test byte 

2 " 

3 CPU-determined number of bytes processed 



Program Exceptions: 

• Access (fetch, operarid 2; store, operand 1) 

♦ Specificatron 

Programming Notes: 

1- When condition code 3 is set, the program 
can simply branch back to the instruction to 
continue the translation. The program need 
not determine the number of bytes that were 
trar^slated- 

2. The instruction can improve performance by 
being used in place of a TRANSLATE AND 
TEST instruction that locates an escape char- 
acter, followed by a TRANSLATE instruction 
that translates the bytes preceding the escape 
character. 

3, The storage operand references of TRANS- 
LATE EXTENDED may be multiple-access 
references. (See ''Storage-Operand 
Consistency" on page 5-86.) 
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TRANSLATE ONE TO TWO 
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TRANSLATE TWO TO TWO 

TRTT Ri,R« [RRE] 
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The characters of the second operand are used 
as arguments to select function characters from a 
translation table designated by the address in 
genera! register 1. Each function character 
se)ected from the translation table is compared to 
a test character in general register 0, and, unless 
an equal comparison occurs, is placed at the first- 
operand location. The operation proceeds until a 
selected function character equal to the test char- 
acter Is encountered, the end of the second 
operand is reached, or a CPU-detemiined number 
of characters have been processed, whichever 
occurs first. The result is indicated in the condi- 
tion code. 

The lengths of the operand and test characters 
are as follows: 

• For TRANSLATE ONE TO ONE. the second- 
operand, first-operand, and test characters are 
single bytes. 

• For TRANSLATE ONE TO TWO. the second- 
Operand characters are single bytes, and the 
first-operand and test characters are double 
bytes. 

• For TRANSLATE TWO TO ONE, the second- 
operand characters are double bytes, and the 
first-operand and test characters are single 
bytes, 

• For TRANSLATE TWO TO TWO, the second- 
operand, first-operand, and test characters are 
double bytes. 

For TRANSLATE ONE TO ONE and TRANSLATE 
TWO TO ONE, the test character is in bit posi- 
tions 56-63 Of general register 0. For TRANS- 
LATE ONE TO TWO and TRANSLATE TWO TO 
TWO, the test character is in bit positions 48-63 of 
general register 0. 

The Ri field designates an even -odd pair of 
general registers and must designate an even- 
numbered register; otherwise, a specification 
exception is recogni26d. 



TTie location of the leftmost byte of the first 
operand and second operand is designated by the 
contents of general registers Ri and Rs, respec- 
tively. In the 24-bit or 31 -bit addressing mode, the 
number of bytes in the second-operand location is 
specified by the contents of bit positions 32-63 of 
general register Ri + 1, and those contents are 
treated as a 32-bit unsigned binary integer. In the 
64-bit addressing mode, the number of bytes in 
the second-openand iocation is specified by the 
contents of bit positions 0-63 of general register 
Ri + 1, and those contents are treated as a 
S4-bit unsigned binary integer. The length of the 
first-operand location is considered to be the same 
as that of the second operand for TRANSLATE 
ONE TO ONE and TRANSLATE TWO TO TWO, 
twice that for TRANSLATE ONE TO TWO. and 
one half that for TRANSLATE TWO TO ONE. 

For TRANSLATE TWO TO ONE and TRANS- 
LATE TWO TO TWO, the length in general reg- 
ister Ri + 1 must be an even number of bytes; 
othenwise, a specification exception is recognized. 

The translation table is treated as being on a 
doubleword boundary for TRANSLATE ONE TO 
ONE and TRANSLATE ONE TO TWO and on a 
4K-byte boundary for TRANSLATE TWO to ONE 
and TRANSLATE TWO TO TWO- The rightmost 
bits of the register that are not used to form the 
address, which are bits 61-63 in the doubleword 
case and bits 52-63 in the 4K-byte case, are 
ignored. 

The handling of the addresses in general registers 
Ri, Ra, and 1 is dependent on the addressing 
mode. 

In the 24-bit addressing mode, the contents of bit 
positions 40-63 of general registers Ri and Ra 
and 40-60 or 40-51 of 1 constitute the address, 
and the contents of bit positions 0-39 are ignored. 
In the 31 -bit addressing rrrode, the contents of bit 
positions 33-63 of registers Ri and Rz and 33-60 
or 33-61 Of 1 constitute the address, and the con- 
tents of bit posrtlons 0-32 are ignored. In the 
64-bit addressing mode, the contents of bit posi- 
tions 0-63 of registers Ri and Ra and 0-60 or 0-51 
of 1 constitute the address. 

The contents of the registers just described are 
shown in Figure 7-24 on page 7-154. 
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In the access-register mode, the contents of 
access registers Ri, Ri. and 1 are used for 
accessing the first operand, second operand, and 
transiatron table, respectively. 

The length of the translation table designated by 
the address contained in general register 1 is as 
follows; 

• For TRANSLATE ONE TO ONE, the 
transfation-table length is 256 bytes; each of 
the 256 function characters Is a single byte. 

♦ For TRANSLATE ONE TO TWO. the 
translation-table length is 512 bytes; each of 
the 256 function characters is a double byte. 



• For TRANSLATE TWO TO ONE. the 

translation-table length* is 65,536 (64K) bytes; 
each of the 64K function characters is a single 
byte. 

• For TRANSLATE TWO TO TWO, the 
translation-table length is 131,072 (128K) 
bytes; each of the 64K function characters is a 
double byte. 

The characters of the second operand are 
selected one by one for translation, proceeding left 
to right. Each argument character is added to the 
Initial translation-table address. The addition is 
performed following the rules for address arith- 
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Figure 7^24 (Part 1 of 2). Register Contents for TRANSLATE ONE TO ONE. TRANSLATE ONE TO TWO, TRANS- 
LATE TWO TO ONE, and TRANSLATE TWO TO TWO 
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metic, with the argument character treated as 
follows: 

* For TRANSLATE ONE TO ONE, the argu- 
ment character is treated as an eight-bit 
unsfgned binary integer extended pn the left 
wrth 56 zeros. 

• For TRANSLATE ONE TO TWO, the argu- 
ment Character is treated as an eight-bit 
unsigned binary integer extended on the right 
with a zero and on the left with 55 zeros. 

• For TRANSLATE TWO TO ONE, the argu- 
ment character is treated as a 16-bit unsigned 
binary integer extended on the left with 48 
zeros. 

♦ For TRANSU^TE TWO TO TWO, the argu- 
ment character is treated as a 16*bit unsigned 
binary integer extended on the right with a 
zero and on the teft with 47 zeros. 



The rightmost bits of the translation-table address 
that are ignored (61-63 or 52-63) are treated as 
zeros during this addition. 

The sum is used as the address of the function 
character. 

Each function character selected as described 
above is first compared to the test character in 
general register 0. If the resurt is an equal com- 
parison, the operation is compJeted, If the func- 
tion character is not equal to the test character, 
the function character is placed in the next avail- 
able character position in the first operand, that is, 
the first function character is placed at the begin- 
ning of the first-operand location, and each suc- 
cessive function character is placed immediately 
to the right of the preceding character. The 
second operand and the translation table are not 
altered unless an overlap occurs. 



Ri 



Ri + 1 



R2 



GRl 



GRl 



64-Bit Addressing Mode 



C 

0 



rst-Operand Address 



63 



Second-Operand Length 



63 



Second-Operand Address 



63 



For TRANSLATE ONE TO ONE 
and TRANSLATE ONE TO TWO 



Translation-Table Address 



/// 



61 63 



For TRANSLATE TWO TO ONE 
and TRANSLATE TWO TO TWO 



Translation-Table Addr, 
L/ 

Q 



//////////// 



52 



63 



FigufB 7-24 (Part 2 of 2), Register Contents for TRANSLATE ONE TO ONE. TRANSLATE ONE TO TWO TRANS- 
LATE TWO TO ONE, snd TRANSLATE TWO TO TVVO 
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The operation prcx^eeds until a selected function 
character equal to the test character is encount- 
ered, the seconcf-operand focation is exhausted, 
or a CPU-determined number of second-operand 
characters have been processed. 

When a selected function character equal to the 
test character 1$ encountered, condition code 1 is 
set. When the second-operand location is 
exhausted without fiiKiing a selected function char- 
acter equal to the test character, condition code 0 
is set. When a CPU-determined number of char- 
acters have t>een processed, condition code 3 is 
set. Condition code 3 may be set even when the 
next character to be processed results in a func- 
tion character equal to the test character or when 
the second-operand location is exhausted. In 
these cases, condition code 1 or 0. respectively, 
vwll be set when the Instruction Is executed again. 

If the operation rs completed with condition code 

0, the contents of general register Rz are incre- 
mented by the contents of general register 
Ri + 1. and the contents of general register Ri 
are incremented as follows: 

• For TRANSLATE ONE TO ONE and TRANS- 
LATE TWO TO TWO, the same as for general 
register Rz. 

• For TRANSLATE ONE TO TWO, by twice the 
amount for general register Ra. 

• For TRANSLATE TWO TO ONE, by one half 
the amount for general register R2. 

The contents of general register Ri + 1 are then 
set to zero- 

If the operation is completed with condition code 

1. the contents of general register Ri + 1 are 
decremented by the number of second-operand 
bytes processed before the character that selected 
a function character equal to the test character 
was encountered, and the contents of general reg- 
ister Ra are incremented by the same number, so 
that general register Rz contains the address of 
the character that selected a function character 
equal to the test character. The contents of 
general register Ri are incremented by the same, 
twice, or one half the number, as descnbed above 
for condition code 0, 

If the operation is completed with condition code 
3, the contents of general register Ri + 1 are 
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decremented by the number of second-operand 
bytes processed, and the contents of general reg- 
ister R2 are incremented by the same number, so 
that the instruction, when reexecuted, contains the 
address of the next character to be processed. 
The contents of general register Ri are incre- 
mented by the same, twice, or one half the 
number, as described above for condition code 0. 

When general registers Rx and Rz are updated in 
the 24-bit or 31 -bit addressing mode, the bits in bit 
positions 32-39 of them that are not part of the 
address may be set to zeros or may remain 
unchanged from their original values. In the 24-bit 
or 31 -bit addressing mode, the contents of bit 
positions 0-31 of general registers Ri, Ri +1, 
and Ri always remain unchanged. 

The contents of general registers 0 and 1 remain 
unchanged. 

The amount of processing that results in the 
setting of condition code 3 is detemiined by the 
CPU on the basis of improving system perform- 
ance, and it may be a different amount each time 
the instniction is executed. 

During instruction execution, CPU retry may result 
in condition code 3 being set with possibly incor- 
rect data having been stored in the first operand 
location at or to the right of the location desig- 
nated by the finai address in general register Ri. 
The amount of data Stored depends on the opera- 
tion and the point in time at which CPU retry 
occurred, in all cases, the storing will occur 
again, with correct data stored, when the instruc- 
tion is executed again to continue pnxessing the 
same operands. 

When the Ri register is the same register as the 
Ri register, the Ri or Ra register is register 0, or 
the Rz register is register 1, the results are unpre- 
dictable. 

When any of the first and second operands and 
the translation table overlaps another of them, the 
results are unpredictable. 

Access exceptions for the portion of the first or 
second operand to the right of the last character 
processed may or may not be recognized. For an 
operand longer than 4K bytes, access exceptions 
are not recognized for locations more than 4K 
bytes beyond the last character processed. 
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Access exceptions for all characters of the trans- 
lation table may be recognized even rf not all char- 
acters are used. 

Access exceptions are not recognized ff the Ri 
field is odd. When the length of the second 
operand is iero» no access exceptions for the first 
or second operand are recognized, and access 
exceptions for the translation table may or may 
not be recognized. 

Resulting Condition Code: 

0 Entire second operand processed without 
finding a resulting function character equal to 
the test character 

1 Second-operand character found resulting in 
a function character equal to the test char- 
acter 

2 " 

3 CPU-determined number of characters proc- 
essed 

Program Exceptions: 

• Access (fetch, operand 2 and translation table; 
store, operand 1) 

• Operation {if the extended-translation facility 2 
is not installed) 

• Specification 

Programming Notes: 

1 . These instructions differ from the TRANS- 
LATE EXTENDED instruction by having the 
following attributes: 

• Depending on the instruction used, the 
sets of argument characters and function 
characters each can contain single-byte or 
double-byte characters. 

* The test character is compared to a 
resulting function character instead of to 
an argument character. 

♦ The argument (source) «uid function (des- 
tination) operands are different operands. 

2. When condition code 3 is set, the program 
can simply branch back to the instruction to 
continue the translation. The program need 
not determine the number of characters that 
were translated. 

3. The storage operand references of these 
instructions may be multiple-access refer- 



ences. (See "Storage-Operand Consistertcy" 
on page 5-86.) 
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The format of the second operand is changed 
from packed to zoned, and the result is placed at 
the first-operand location. The paclced and zoned 
formats are described in Chapter 8, "Decimal 
Instructions." 

The second operand is treated as having the 
packed format. Its digits and sign are placed 
unchanged in the first-operand location, using the 
zoned format Zone bits vwth coding of mi are 
supplied for all bytes except the rightmost byte, 
the zone of which receives the sign of the second 
operand. The sign and digits are not checked for 
valid codes. 

The result is obtained as if the operands were 
processed right to Jeft. When necessary, the 
second operand is considered to be extended on 
the left with zeros. If the first-operand field is too 
short to contain all digits of the second operand, 
the remaining leftmost portion of the second 
operand is ignored. Access exceptions for the 
unused portion of the second operand may or may 
not be indicated. 

When the operands overlap, the result is obtained 
as if the operands were processed one byte at a 
time and as if the first result byte were stored 
immediately after fetching the first operand byte. 
The entire rightmost second-operand byte is used 
in fomiing the first result byte. For the remainder 
of the field, infonmatlon for two result bytes is 
obtained from a single second-operand byte, and 
execution proceeds as if the leftmost four bits of 
the byte were to remain available for the next 
result byte and need not t>e refetched. Thus, the 
result is as if two result bytes were to be stored 
immediately after fetching a single operand byte. 

Condition Code: The code remains unchanged. 
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